home *** CD-ROM | disk | FTP | other *** search
/ Teach Yourself VRML 2 in 21 Days / Teach Yourself VRML 2 in 21 Days.iso / mac / ISO9660 / 3rdparty / POLYTRAN / dos / PT_DOS.ZIP / DOC_1 / IMP_IGES.1 < prev    next >
Encoding:
Text File  |  1996-06-13  |  3.6 KB  |  87 lines
  1. .so psroff.inc        # Include the macros needed for output to Postscript
  2. .TH Import-IGES
  3. .SH NAME
  4. imp_iges \- IGES geometry import filter
  5. .SH SYNOPSIS
  6. .PP
  7. This man page describes the options specific to the IGES 4.0 geometry
  8. import converter.
  9. .PP
  10. .SH EXAMPLE CONVERSION SYNTAX
  11. .PP
  12. To convert an IGES file to Wavefront using the default parameters listed 
  13. in the setup.ini file:
  14. .IP
  15. pt -i iges -o wave filename.igs
  16. .PP
  17. To convert an IGES file to VRML and override some of the default options 
  18. in setup.ini:
  19. .IP
  20. pt -i iges -in-iges-verbose = yes -o vrml filename.igs
  21. .PP
  22. .SH OVERVIEW
  23. .PP
  24. This geometry import converter reads in IGES 4.0 ASCII files. All entities are 
  25. parsed and stored temporarily in memory but only entities 106 (polygons) and 
  26. 128 (NURB patches) are currently sent to the internal geometry database. 
  27. .PP
  28. All polygonal data will be stored internally using one 'Indexed Polygon' 
  29. (mesh) primitive. NURB data will be stored internally in their native form.
  30. .PP
  31. .SH COMMAND LINE OPTIONS
  32. .PP
  33. The following options are specific to this import converter:
  34. .TP
  35. -i iges
  36. This is the optional command line option which specifies that the input data
  37. is in the IGES file format. If not specified then the converter will try 
  38. to guess the input file's format from its file extension (.igs or .iges) 
  39. and then from the contents of its file. 
  40. .TP
  41. -in-iges-compute-normals = [ yes | no ]
  42. If set to 'yes' then new vertex normals will be computed for a polygon 
  43. if it does not have any vertex normals already. The smoothing criterion is 
  44. based on the angle between abutting polygons; common smoothed vertex normals 
  45. will be computed if the angle between their geometric surfaces normals is 
  46. less than the '-in-iges-smoothing-angle' angle described below. If set to
  47. 'no' then no new vertex normals will be created.
  48. .TP
  49. -in-iges-smoothing-angle = #
  50. This option sets the cut-off smoothing angle (in degrees) used by the vertex normal
  51. computation algorithm. If the angle between two abutting polygons is greater
  52. than this number then no smoothing will occur (a crease will be evident
  53. between the two polygons), else smoothing will occur where the polygons
  54. meet. The default angle is 30 degrees.
  55. .TP
  56. -in-iges-debug-mode = [ yes | no ]
  57. If set to 'yes' then this converter will print out information about the 
  58. tokens it is currently parsing in the file.
  59. .TP
  60. -in-iges-verbose = [ yes | no ]
  61. If set to 'yes' then this converter will print out verbose information 
  62. about the IGES file as it is being parsed. No data will actually be read into 
  63. memory.
  64. .TP
  65. -in-iges-report-unsup-entities = [ yes | no ]
  66. If set to 'yes' then this converter will print out information about the
  67. IGES entities which are not supported by the IGES parser.
  68. .PP
  69. .SH CONVERTER LIMITATIONS
  70. .PP
  71. .IP
  72. Due to the fact that some IGES files are not written with 100% conformance to 
  73. the IGES standard this import filter is not guaranteed to read non-conforming 
  74. IGES files. The converter will report the offending line number which you
  75. will have to try and correct by hand.
  76. .IP
  77. Only ASCII IGES files can be read. Binary reading is not accommodated.
  78. .IP
  79. This converter is compliant with the IGES v4.0 specification. Files written
  80. with a newer version of IGES will read in fine but any new entities will
  81. not be supported.
  82. .IP
  83. Although the IGES format has a rich set of NURB surfaces, such as surfaces
  84. of revolution, extrusions and birail surfaces, this converter will only
  85. read in the NURB patch entity. In addition, no NURB trimming curve data
  86. is converted at this time.
  87.